home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / icon / czesc_2 / magicexpansion / docs / english / me13.doc next >
Text File  |  1994-08-12  |  10KB  |  301 lines
  1.  
  2.  
  3.  
  4.                              MagicExpansion
  5.  
  6.                  Useful expansions for MagicWB and MUI
  7.  
  8.                        Version 1.3 (August 1994)
  9.  
  10.                   Copyright © 1994 by Johannes Beigel
  11.  
  12.                                 GIFTWARE
  13.  
  14.  
  15.  
  16.  
  17.  
  18. Introduction
  19. ************
  20.  
  21. MagicExpansion is a package with  lots  of  expansions  for  MagicWB  by
  22. Martin  Huttenloher  and  MUI  (MagicUserInterface)  by  Stefan  Stuntz.
  23.  
  24. MagicExpansion ist GIFTWARE. That means you should send me a little
  25. gift, if you use MagicExpansion (I prefer CDs/MCs/LPs with all kinds of
  26. rock, techno, jazz or blues music :)
  27.  
  28. Address:       Johannes Beigel
  29.                Fliederstr. 43a
  30.                65396 Walluf
  31.                GERMANY
  32.  
  33. Yes, you've read right. After  version  1.2,  which  was  Shareware,  is
  34. MagicExpansion   1.3   Giftware   again.   Users,   who  registered  for
  35. MagicExpansion  1.2  will  still   get   the   following   versions   of
  36. MagicExpansion.
  37.  
  38.  
  39. Why Giftware again?
  40. ===================
  41.  
  42. Mr. F.B. sent a comment to Internet in which he  said  how  he  dislikes
  43. MagicExpansion.  I  must say, that he was right in several points. But I
  44. don't guess that I violate the copyright, when  I  use  parts  of  other
  45. XEN-icons in my icons. I realized that only little people want to pay 10
  46. bucks additionally to the MagicWB and MUI Shareware  fee  (The  one  who
  47. still  wants  to  send me money can do this - MagicExpansion is Giftware
  48. now). Besides, the original XEN-MUI-brushes are deleted from  the  image
  49. sets, the amount of icons gets bigger and the package grows and grows. I
  50. think, *now*, nobody can say anything against  MagicExpansion.  I  swear
  51. that I drew the popXXX-images of 'Jojo_Black_11pt' and 'Jojo_Black_13pt'
  52. *before* I saw the images of the set 'WD_13pt' of MUI 2.1.
  53.  
  54.  
  55. Contents
  56. ********
  57.  
  58. The package contains icons, mouse pointers, palettes, patterns, MUI
  59. brushes, C include file, char sets and a few documentation and picture
  60. files.
  61.  
  62.  
  63. Icons
  64. -----
  65.  
  66. You may have noticed already some of the new icons of this version  1.3:
  67. the small drawer and text file icons. If you open the drawer "Icons" you
  68. will find many more icons. They are stored in different  directories  to
  69. keep them in order.
  70.  
  71. The icons are drawn in XEN-style (MagicWB like icons).  Some  icons  are
  72. very small, some icons are bigger. Use the icons you prefer.
  73.  
  74. If you want to draw icons yourself you can use the icon templates on the
  75. picture file "Templates.ilbm" in the "Pictures" drawer.
  76.  
  77.  
  78. Mouse Pointers
  79. --------------
  80.  
  81. NOTE: Users of ME 1.2 can skip this chapter  since  the  mouse  pointers
  82. haven't changed.
  83.  
  84. In this package are several 4 and 8 color  mouse  pointers  for  OS  2.x
  85. users.  Of  course OS 3.x users can use them, too, but the pointers were
  86. drawn for lo-res sprites. All the mouse pointers use at least one  color
  87. for   anti-aliasing.   Since   the  resolution  is  very  low  you  need
  88. anti-aliasing!
  89.  
  90. You'll find a few busy- (or sleepy-) pointers and -animations, too. They
  91. can be used with the BusyPointer prefs editor from the NickPrefs package
  92. which is included in the MagicWB package.
  93.  
  94. NOTE: If you want to use the bee (or its animation) as busy pointer  you
  95. have  to use a mouse pointer that uses the color yellow because the busy
  96. pointer uses the same colors as the normal mouse pointer. Otherwise  you
  97. will get a lilac bee or something like that :)
  98.  
  99. If you are an OS 2.x user and you want to use the 8 color pointers,  you
  100. can't  load  and  save  them  with  the  Pointer  prefs editor, since it
  101. processes only 4 color sprites. So you have to copy the pointer you want
  102. to     use     directly     to    "ENVARC:sys/pointer.ilbm"    (or    to
  103. "ENV:sys/pointer.ilbm" if you only want to USE it):
  104.  
  105.       Copy MagicExpansion/Pointers/XXX TO ENVARC:sys/pointer.ilbm
  106.  
  107. (You must replace XXX with the name of the mouse pointer.)
  108.  
  109.  
  110. Palettes
  111. --------
  112.  
  113. NOTE: Users of ME 1.2 can skip this part, too :-(
  114.  
  115. You got a few color palettes with this packages.  These  color  palettes
  116. should  be  alternatives  to  the original MagicWB palette. The palettes
  117. exist as old-style OS 2.x ".pre" files and as OS 3.x ".ilbm" files.  The
  118. installation  script  will  install  the  right palettes for you, so you
  119. don't have to care about this.
  120.  
  121. The color palettes "OriginalPalette.pre" and "OriginalPalette.ilbm"  are
  122. the original MagicWB palettes.
  123.  
  124.  
  125. Patterns
  126. --------
  127.  
  128. There are a few background patterns in this package  for  the  WBPicture
  129. prefs  editor of the NickPrefs package or for the WBPattern prefs editor
  130. of OS 3.x and a few old-style window patterns for  the  WBPattern  prefs
  131. editor of OS 2.x.
  132.  
  133. The background patterns use the original  MagicWB  palette,  so  OS  2.x
  134. users can use them immediatly without converting.
  135.  
  136.  
  137. MUI Brushes
  138. -----------
  139.  
  140. The package contains 6 sets of MUI brushes (so called "MUI image sets"):
  141.  
  142.     "Jojo_Black_11pt",
  143.     "Jojo_Black_13pt",
  144.     "Jojo_3D_11pt",
  145.     "Jojo_3D_13pt",
  146.     "Jojo_Outline_11pt",
  147.     "Jojo_Outline_13pt",
  148.     "Jojo_Blue_11pt",
  149.     "Jojo_Blue_13pt" and
  150.     "Jojo_TapeDeck".
  151.  
  152. The image sets should be used with a 11 or 13 pixel font.
  153.  
  154. The image set "Jojo_Black_11pt" contains images for arrows, all kinds of
  155. popup  objects, checkmarks, radio buttons, cycle gadgets, the assign and
  156. network symbols and the tape pause symbol.
  157.  
  158. The other sets only contain the images which are different to the images
  159. in  "Jojo_Black_11pt".  Except  of  the  tape  pause, assign and network
  160. images, all images  look  like  XEN-buttons  (button  gadgets  with  XEN
  161. frames). The tape pause symbol contains simply two vertical bars instead
  162. of one.
  163.  
  164. If you want the images to look best, do the following:
  165.  
  166. - Use a screen with at least 8 colors and a width similar to the  height
  167.   (e.g. 640x512).
  168.  
  169. - Use the MagicWB color palette (or a color palette of this package :)
  170.  
  171. - Use a 11 or 13 pixel font for screen text (The best font  is  Martin's
  172.   XHelvetica.font).
  173.  
  174. - Start the MUI prefs editor.
  175.  
  176. - Chose "XEN Lo" or "XEN Hi" from the "Edit/Presets" sub menu.
  177.  
  178. - Change the images to  the  images  in  "Jojo_Black_..",  "Jojo_3D_..",
  179.   "Jojo_Outline_.." or "Jojo_Blue.." (page "Images").
  180.  
  181. - If you don't have MagicWB (Why do you  have  MagicExpansion??)  change
  182.   the font names from "XHelvetica" to "helvetica" (page "Fonts").
  183.  
  184. You'll find an ILBM format picture file called "JojoMBrKit.ilbm" in  the
  185. "Pictures" drawer. This picture conatins all the images of the sets. You
  186. can use this file as model for your own MUI brushes.
  187.  
  188.  
  189. C Include File
  190. --------------
  191.  
  192. The include file conatins some useful macro definitions for shorter  and
  193. nicer source code:
  194.  
  195. - New macros for adding/removing children to/from their parent objects.
  196.  
  197. -  New  gadget  types:  ...UInteger...(),  ...SInteger...(),  ...Note(),
  198.   KeyPopupButton(), ...ToggleButton(), ...Note(), Number() and Text()
  199.  
  200. - New label type ...CLabel() for centered labels
  201.  
  202. - New spacing macros: HBar, VBar, HBarFixed(), VBarFixed()
  203.  
  204. - "Wt" version for some gadget macros (additional weight argument)
  205.  
  206. - New Slider-macros: ...VSlider(), Quiet...Slider()
  207.  
  208. If you want to use  the  ...Integer...()  or  ...Note()  macros  of  the
  209. include  file,  you  have  to insert the following code before the first
  210. macro call:
  211.  
  212.     TEXT acceptSNumbers[] = ACCEPTSNUMBERS; /* For ..SInteger...() */
  213.     TEXT acceptUNumbers[] = ACCEPTUNUMBERS; /* For ..UInteger...() */
  214.     TEXT acceptNotes[] = ACCEPTNOTES;       /* For      ....Note() */
  215.  
  216. I haven't inserted the lines in the include file because so you can load
  217. the include file into GST files (with the SAS/C compiler) for example.
  218.  
  219.  
  220. Char Sets
  221. ---------
  222.  
  223. The package contains 4 color char sets. The char sets are ideal for your
  224. own  icon  or background projects, bacause they use the MagicWB palette.
  225. The following fonts are in the package:
  226.  
  227.     - Helvetica/23
  228.     - Hevletica/23 plain
  229.     - Times/21
  230.     - Times/21 plain
  231.  
  232. The fonts don't exist as normal color fonts but every char exists  as  a
  233. single  IFF/ILBM  brush.  The  reason  is,  that I haven't got a tool to
  234. convert brushes to fonts.  I  would  know  a  tool,  but  this  tool  is
  235. Shareware  and  it's  so  bad that I won't pay the shareawre fee. If you
  236. have written such a program or if you know a nice tool (which has a  MUI
  237. GUI :) it would be nice, if you tell me its name or if you send it to me
  238. on disk.
  239.  
  240.  
  241. Installation
  242. ************
  243.  
  244. NOTE: You need the Commodore  Installer  to  install  the  package.  The
  245. Installer  is  included  in many commercial software packages and in the
  246. MUI package.
  247.  
  248. To install simply double-click one of the icons in the "Install" drawer.
  249. Since  you  read  the  English  documentation  you will probably use the
  250. script "Install_ME13_English". After that you should do what the  script
  251. tells you.
  252.  
  253. The script won't install any icons so you have to update your old  icons
  254. by hand. If you want to preserve position and tooltypes use "IconUpdate"
  255. from MagicWB or the tool "MUI_IconUpdate" (Freeware) which does the same
  256. job  but has a MUI GUI. (Re)Read the MagicWB documentation for the usage
  257. of "IconUpdate".
  258.  
  259.  
  260. Copyright
  261. *********
  262.  
  263. MagicExpansion is copyright © 1994 by Johannes Beigel.  The  package is
  264. Giftware (see chapter Introduction for details).
  265.  
  266. You are allowed to spread MagicExpansion all over the world using email,
  267. disks,  CD-Rom  or  any  other  medium  but  you must spread the *whole*
  268. package.   You   should   use   the   original   ".lha"   file    called
  269. "MagicExpansion_13.lha".
  270.  
  271. You aren't allowed to take more than DM 5,- or US$ 5,- for it (including
  272. disk and copying costs but not the postage).
  273.  
  274. If you want to include  files  from  this  package  into  non-commercial
  275. software  (Shareware,  Freeware, Giftware, Crippleware, ...) you have to
  276. send the product to me (address see chapter Introduction).
  277.  
  278. If you want to include this package (or parts of it) into a commercial
  279. product you *have* to contact me.
  280.  
  281.  
  282. Thanks
  283. ******
  284.  
  285. I want to thank the following persons:
  286.  
  287. - Stefan Stuntz for his MagicUserInterface. I think  this  is  the  best
  288.   Amiga software product since years!
  289.  
  290. - Martin Huttenloher and all the other painters for their MagicWB icons
  291.   and backgrounds.
  292.  
  293. - ICP-Verlag (AmigaPlus) and Cloanto for "PersonalPaint 2.1" with  which
  294.   all  icons,  brushes,  palettes,   patterns,  char sets  and  pointers
  295.   were made.
  296.  
  297. - All MUI programmers who make MUI more and more popular.
  298.  
  299. - Martin Schulze fpr everything
  300.  
  301.